TextSnapshot.getSelectedText()

Доступность

Среда разработки: Flash MX 2004.

Плеер: SWF файлы, опубликованные для Flash Player 6 или более поздних версий, проигрываются во Flash Player 7 и более поздних.

Синтаксис

my_snap.getSelectedText( [ includeLineEndings:Boolean ] ) : String

Параметры

includeLineEndings Необязательная булева величина, определяющая, включается ли в возвращаемую строку символ переноса строки там, где это требуется. Значением по умолчанию является false.

Возвращает

Строку, содержащую все символы, выделенные при помощи метода TextSnapshot.setSelected()

Описание

Метод; возвращает строку, содержащую все символы, выделенные при помощи метода TextSnapshot.setSelected(). Если выделенных символов нет, возвращается пустая строка.

Если вы передаете значение true параметру includeLineEndings, в строку, если это необходимо, вставляются символы переноса строки. Если includeLineEndings передано значение false или опущен, выделенный текст возвращается без добавления символов.

Пример

Код в нижеследующем примере показывает, как пользоваться данным методом. Перед использованием этого кода, разместите на Сцене статическое текстовое поле с текстом “TextSnapshot Example”. Create a dynamic text field on the Stage, select it, and click the Character button in the Property inspector. Select Specify ranges and enter any character into the Include These Characters text field. For more information on this process, see TextSnapshot.setSelected(). Add the following ActionScript to Frame 1 of the Timeline.

// В этом примере предполагается, что мувиклип содержит
// статическое текстовое поле с текстом "TextSnapshot Example"
var my_snap:TextSnapshot = this.getTextSnapshot();
var count:Number = my_snap.getCount();
my_snap.setSelectColor(0xFF0000); // устанавливаем цвет выбранных символов
my_snap.setSelected(0, 4, true); // выбираем первые четыре символа
my_snap.setSelected(1, 2, false); // сбрасываем выделение второго символа (остальные остаются выделенными)

var firstCharIsSelected:Boolean = my_snap.getSelected(0, 1);
var secondCharIsSelected:Boolean = my_snap.getSelected(1, 2);
var theText:String = my_snap.getSelectedText(false); // получаем выбранный текст
trace(theText); // выводит: Txt
trace(firstCharIsSelected); // выводит: true
trace(secondCharIsSelected); // выводит: false

При тестировании SWF файла, вы увидите цветные прямоугольники вокруг выделенных символов.

См. также

TextSnapshot.getSelected()

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление